Remove

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODStorageUnitView

Remove
The Remove method removes all properties and values in the focus context from the storage unit that created this storage-unit view.
ODStorageUnitView Remove ();
return value
A reference to this storage-unit view.

DISCUSSION
If the focus context of this storage-unit view is the entire storage unit, this method removes all properties and their values. If the focus context is a property, this method removes the focused property and all its values. If the focus context is a value, this method removes the focused value.
After this method executes successfully, the storage unit that created this storage-unit view is unfocused. The focus context of this storage-unit view is unchanged.
This method should be used with caution; if it executes successfully, it makes the focus context of this storage-unit view invalid.

EXCEPTIONS
If the storage-unit cursor for this storage-unit view does not represent a legal focus context for the storage unit that created this storage-unit view, this method throws exceptions raised by the FocusWithCursor method of that storage unit.

SEE ALSO
The ODStorageUnitView::AddProperty method (page 728).
The ODStorageUnitView::AddValue method (page 730).